home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / ts3j.zip / TELEFILE.DOC < prev    next >
Text File  |  1994-12-16  |  15KB  |  401 lines
  1.  
  2.  
  3.                      The TELEFILE.DOC           Page 1
  4.  
  5.  
  6.  
  7.  
  8.                      Version 1.00     December, 1994
  9.  
  10.  
  11.                              _______
  12.                         ____|__     |               (R)
  13.                      --|       |    |-------------------
  14.                        |   ____|__  |  Association of
  15.                        |  |       |_|  Shareware
  16.                        |__|   o   |    Professionals
  17.                      -----|   |   |---------------------
  18.                           |___|___|    Member
  19.  
  20.  
  21.  
  22.           Telefile helps you select a list of files in a directory, then
  23.           tell an external file transfer program, via a list in a file
  24.           called FILES.UP, to transfer those files to another computer.
  25.           Most of the time you can get by using Telefile's on-line help,
  26.           but you might review this manual just to keep in practise.
  27.           Telefile is part of the TeleShare remote support & access
  28.           package, and is derived from our UPKEEP package.
  29.  
  30.  
  31.           You may have noticed some Telefile related files.  Most of
  32.           them are automatically used by Telefile as needed.  Even the
  33.           online help and this manual are available from the help menu
  34.           option.
  35.  
  36.           Telefile.exe is the Telefile executable file.
  37.  
  38.           Telefile.doc is this manual.
  39.  
  40.           Telehelp.dbf & .dbt contain the user changeable help.
  41.  
  42.           Telefile.his is the DOS menu history file.  It records what
  43.           you run from the DOS menu so you can easily repeat or edit
  44.           then repeat your actions.  For example, if you run "DIR/W"
  45.           from the DOS menu it will be recorded in the history file and
  46.           in a list in memory where you will be able to quickly select
  47.           it and repeat it.  You can quickly edit it with your text
  48.           editor to add, change, or delete entries.  The "#" symbol is
  49.           used as a comment, so the menu will ignore anything occurring
  50.           after the # when you select an entry from the list of choices
  51.           displayed.  If you wish you can add 1000's of batch file names
  52.           for file transfers, backups, copying, and moving files with
  53.           gather.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                      The TELEFILE.DOC           Page 2
  61.  
  62.  
  63.  
  64.           Telefile.cfg is a configuration file that Telefile uses to
  65.           record or 'remember' what you are up to, so you can quit and
  66.           resume where you left off.  Two example values that are stored
  67.           in telefile.cfg are the settings for 1) quitting and 2)
  68.           swapping to disk versus just running when the hangup.bat and
  69.           makecall.bat files are automatically run by telefile.exe You
  70.           can save the current settings in telefile.cfg by choosing Save
  71.           in the file menu.
  72.  
  73.  
  74.           PHONE.TEL is the name and telephone number file used with
  75.           Telefile and many dialers.  Its normal format is:
  76.  
  77.           # <- these are used for comments
  78.           # The file format is description                            phone #
  79.           Sam Husband                                               455-2365
  80.  
  81.           Its a normal ascii text file that you can edit with any simple
  82.           text editor if you do not wish to use Telefile.  Only lines
  83.           containing a '-' are considered to contain phone numbers.  If
  84.           you want to display a # commented line, then add a '-'
  85.           somewhere on the line.  We like to use '#-' for lines to
  86.           display as in:
  87.  
  88.           #- The following people & numbers are part of our Somebody's
  89.           #- Clothiers maintenance contract.
  90.           #-
  91.           Ted White                                                  544-2323
  92.  
  93.  
  94.  
  95.           The Telefile.INI configuration file.  This INI file contains
  96.           various settings for Telefile.  The ones to setup correctly
  97.           are:
  98.  
  99.           DIALER    - to dial the phone
  100.           GATHER    - the gather setup
  101.           AGING     - days aging for gather backups
  102.           FILE_LIST - the dirdbf setup to list directories
  103.           EDITOR    - your text editor
  104.           DIALFILE  - the optional list of phone numbers
  105.           # the # symbol comments the rest of the line
  106.  
  107.           Most of the others are relics from UPKEEP, and are retained
  108.           because more features may be stolen from UPKEEP in future
  109.           releases.
  110.  
  111.           [TELEFILE]  # TELEFILE initialization file
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                      The TELEFILE.DOC           Page 3
  118.  
  119.  
  120.  
  121.           # some alternate dialer settings follow.
  122.           # only the entry without a leftmost # is active.
  123.           #dialer = SCOMM -d
  124.           # $(NUMBER) is replaced by the telephone number at run time
  125.           dialer = echo $(NUMBER) | dialer /c2
  126.           #dialer=at dt$(NUMBER)
  127.           #gather = gather -show -archive -DAYS @files.up
  128.           gather = gather -show -archive @files.up
  129.           file_lister = dirdbf -DIR -QQ -XD -Z -SD  # directory & file name
  130.           editor = q          # the default editor
  131.           aging = 3           # the oldest file to collect in days
  132.           dialfile = PHONE.TEL
  133.           archiver = pkzip -u    # archive or compress the file(s)
  134.           unarchiver = pkunzip     # extract or unarchive the file(s)
  135.           listing = pkunzip -v    # list the archive file(s)
  136.           listfile = pkunzip $(ZIPFILE) -@$(TMPFILE)
  137.           view_contents = pkunzip -c # view the contents of the selected file
  138.           suffix = ZIP     # the archive file suffix eg .lzh .zip .arc
  139.           backup_name = bak$(DAY)$(HOUR)     # the backup file name
  140.           restore_name =
  141.           password = -sPASSWORD     # a password
  142.           filemask = *.*      # the default file mask when archiving
  143.           logging = y         # the log file or action history switch
  144.           format = y          # always format  yes or no
  145.           formatter = format  # the DOS format or another
  146.           message= Please carefully press any key to restore the screen
  147.  
  148.           Tele.ini is the general Teleshare .ini file.
  149.  
  150.           Telefile works with some other utilities as follows:
  151.  
  152.  
  153.           Gather has a range of file management capabilities including
  154.           archive management.  These features are described in the
  155.           GATHER.DOC, with a summary below.
  156.  
  157.           gather = gather -show -archive -DAYS5 @files.up
  158.  
  159.           This setting is a gather command line that can be used when
  160.           Telefile runs gather to archive or unarchive files less than 6
  161.           days old.
  162.  
  163.           -show      tells gather to display its actions
  164.           -archive   tells gather that it is archiving
  165.           -days      tells gather to collect files based on the
  166.                      file age in days.  The 'aging' value will come
  167.                      after '-days' in archive batch files.
  168.           @files.up  a file listing the files to be archived.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                      The TELEFILE.DOC           Page 4
  175.  
  176.  
  177.  
  178.                      Telefile generates this file.
  179.  
  180.           Gather gathers specified files from specified directories and
  181.           copies, archives, or moves, them to a destination directory.
  182.           This allows one to collect copies of crucial files, such as
  183.           the AUTOEXEC.BAT, or database files, into a central directory
  184.           for transfer to another computer as a backup and for ongoing
  185.           remote maintenance and diagnosis.
  186.  
  187.           You can also just type in "GATHER" and it will produce a usage
  188.           screen.
  189.  
  190.  
  191.           Dirdbf is a file and directory finder and lister.  It collects
  192.           these lists in Xbase .DBF or ascii text files.  Telefile uses
  193.           the directory lists generated in 'DIRECTRY.x' files.  The
  194.           file_lister in TELEFILE.INI is normally DIRDBF with its
  195.           command line switches for collecting the lists of directories
  196.           for your working drives.  Telefile runs DIRDBF to produce a
  197.           file called 'directry', then renames 'directry' to match the
  198.           drive.  A directory listing for drive C:  will become
  199.           'directry.C'.  There are other tools like FFF (fast file
  200.           finder) that could be used the same way.
  201.  
  202.           The DIRDBF tool can be used to create text file lists as well
  203.           as directory lists for your drives.  It normally runs
  204.           automatically based on the settings in the active INI file,
  205.           but you can just type in its name 'DIRDBF' to see its usage.
  206.           It can also create the lists in xbase .dbf files, which can be
  207.           useful if you use dBase or compatible tools.
  208.  
  209.  
  210.           Fformat is a simple standalone diskette formatter.  Its
  211.           advantage over some competitors is that it CANNOT be used to
  212.           format a hard drive, and considerable detail must be provided
  213.           when formatting diskettes.  This helps maintain file
  214.           security.  Type in "FFORMAT" to discover its usage.
  215.  
  216.  
  217.           Other External files and transfer protocols:
  218.  
  219.           Telefile uses simple batch files to send and receive files.
  220.           The default send batch file is SEND.BAT, and the default
  221.           receive is RECEIVE.BAT.  Normally, XM resides in these files.
  222.           You can also use any number of other batch files for external
  223.           protocols, and Telefile will display a list of them for you on
  224.           demand.  The convention is to add an 'S' on the front of Send
  225.           batch files, and an 'R' on Receive batch files.  The DSZ type
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                      The TELEFILE.DOC           Page 5
  232.  
  233.  
  234.  
  235.           RZ.BAT and SZ.bat match this well.  You might also have a
  236.           Rymodem.bat and an Symodem.bat etc.
  237.  
  238.           This release contributes very little to the batch files.  It
  239.           assumes that a Send batch file uses a response or
  240.           configuration file listing the files to be transferred.
  241.           Normally, you will include @FILES.UP in the Send batch file,
  242.           and Telefile will maintain it for you.  Receive batch files
  243.           are expected to to receive without specifying filenames.
  244.  
  245.           SEND.BAT
  246.           rem  XM is the default.  pcz and dsz are commented out
  247.           xm s @files.up
  248.           rem pcz 2 sz @files.up
  249.           rem dsz port 2 speed 115200 d sz  @files.up
  250.  
  251.  
  252.           RECEIVE.BAT
  253.           rem XM is the default.   pcz and dsz are commented
  254.           xm r
  255.           rem pcz rz
  256.           rem dsz rz
  257.  
  258.  
  259.           SUPPORT
  260.  
  261.           For technical support, either call (604) 433-5189, or write to
  262.           Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia,
  263.           Canada, V5H 4E4.  Both registered and soon to be registered
  264.           users currently get the same support without any arbitrary
  265.           time limit.  You may also try leaving a Compuserve message at
  266.           75020, 2664, or better yet send email to
  267.  
  268.           INTERNET:vic_williams@mindlink.bc.ca
  269.  
  270.  
  271.           P.C. Softsmith                       (604) 433-5189
  272.           Suite 606 - 6455 Willingdon Avenue,
  273.           Burnaby, British Columbia,
  274.           Canada, V5H 4E4
  275.  
  276.  
  277.           Please consider reporting the circumstances of ANY interesting
  278.           tidbits that you discover (this includes problems and outright
  279.           bugs), preferably in written form, to our technical support.
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                      The TELEFILE.DOC           Page 6
  289.  
  290.  
  291.  
  292.           This product is Copyright (C) 1993-4 P. C. Softsmith all
  293.           rights reserved.  It is distributed as shareware and must be
  294.           distributed with this documentation.  It is normally
  295.           distributed with other P.C. Softsmith materials that further
  296.           explain the shareware process.  If you wish to distribute it
  297.           with your software or are unable to find the other
  298.           documentation that should accompany this file (such as the
  299.           SHR_WARE.DOC, FILE_ID.DIZ, and the VENDOR.DOC) please contact
  300.           whoever gave you the software or P.C. Softsmith. If you just
  301.           want to use this product on its own, you may license its use
  302.           for $US 10.00.
  303.  
  304.  
  305.           History: (by date & version)
  306.  
  307.           1.00  December, 1994
  308.           Telefile is derived from a similar file backup/archiving
  309.           tool called UPKEEP with its release dates shown next.
  310.           2.00  August, 1994
  311.           expanded, embellished and tuned for general usage.
  312.           1.00 was released in 1993.
  313.  
  314.           A short description of UPKEEP follows:
  315.  
  316.           Upkeep is a simple menu system and DOS shell designed to
  317.           handle archivers for archiving and unarchiving.  This enables
  318.           you to use upkeep for archive management and as a form of
  319.           backup and restore tool.  Upkeep provides a front end that
  320.           allows you to add, extract, list, and select files within
  321.           archives.  Upkeep allows you to view lists of the directories
  322.           on your drives, then change and select one.  Then you can
  323.           select one or more files to include in the archive file that
  324.           will be created.  Or you can use the same process in reverse
  325.           to indicate where to extract or unarchive files.  Plus, you
  326.           can select alternate INI configuration files to switch among
  327.           any number of archivers.  Upkeep produces file lists and
  328.           controlling batch files that provide you the option to bypass
  329.           upkeep once you have setup a particular backup/archive
  330.           scheme.  You can quickly catch onto upkeep's ways of doing
  331.           things by running through its menus and using its on-line
  332.           help.  'Drive it around the block' a few times and see for
  333.           yourself.
  334.  
  335.  
  336.           ASP Introduction:
  337.  
  338.           Please also carefully read the accompanying SHR_WARE.DOC
  339.           document.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                      The TELEFILE.DOC           Page 7
  346.  
  347.  
  348.  
  349.           "This program is produced by a member of the Association of
  350.           Shareware Professionals (ASP). ASP wants to make sure that the
  351.           shareware principle works for you. If you are unable to
  352.           resolve a shareware-related problem with an ASP member by
  353.           contacting the member directly, ASP may be able to help. The
  354.           ASP Ombudsman can help you resolve a dispute or problem with
  355.           an ASP member, but does not provide technical support for
  356.           members' products. Please write to the ASP Ombudsman at 545
  357.           Grover Road, Muskegon, MI 49442 or send a CompuServe message
  358.           via CompuServe Mail to ASP Ombudsman 70007,3536."
  359.  
  360.  
  361.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
  362.           SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
  363.           ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
  364.           THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
  365.           WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE
  366.           PART OF THE VENDOR.
  367.  
  368.           OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
  369.           REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.